home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / satellit / vs108 / viewsat.doc < prev    next >
Text File  |  1992-12-08  |  40KB  |  751 lines
  1.          
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 ViewSat
  10.  
  11.                        Satellite Viewing Program
  12.  
  13.                            December 8, 1992
  14.  
  15.  
  16.  
  17.                            Copyright (c) 1992
  18.                          By David J. Rasmussen
  19.                           All Rights Reserved
  20.  
  21.  
  22.  
  23.                           David J. Rasmussen   
  24.                           10374 Palmento Dr.   
  25.                          Riverside, Ca. 92505  
  26.  
  27.  
  28.                              _______
  29.                         ____|__     |               (tm)       
  30.                      --|       |    |-------------------       
  31.                        |   ____|__  |  Association of
  32.                        |  |       |_|  Shareware
  33.                        |__|   o   |    Professionals
  34.                      -----|   |   |---------------------
  35.                           |___|___|    MEMBER
  36.  
  37.  
  38.  
  39.        ALL VERSIONS OF VIEWSAT ARE NOT PUBLIC DOMAIN SOFTWARE, NOR ARE 
  40.        THEY FREE SOFTWARE.
  41.  
  42.        Non-registered users are granted a limited license to use ViewSat 
  43.        on a trial basis for the purpose of determining whether ViewSat 
  44.        is suitable for their needs. The term of the trial basis shall 
  45.        not exceed 30 days. Use of ViewSat, except for this limited 
  46.        purpose, requires registration. Use of non-registered copies of 
  47.        ViewSat by any business, corporation, governmental agency, or 
  48.        other entity institution is strictly forbidden. The program will 
  49.        notify you when the evaluation period has elapsed.
  50.  
  51.        This document is a complete description of the program, including 
  52.        the license that will be granted upon registration.  There are no 
  53.        surprises.  If you have questions or suggestions, or if you need 
  54.        assistance, you may send EMail on Compuserve to 75176,1775 or 
  55.        write to the address at the end of this document or phone me at 
  56.        (909) 687-4344.
  57.  
  58.        We encourage you to register your use of ViewSat. Registered 
  59.        ViewSat users receive a diskette containing the current version 
  60.        of the registered program, notification of new releases, and 
  61.        enthusiastic support from the author when needed for a period of
  62.        at least 3 months from the date of registration. The registered 
  63.        version of ViewSat is functionally identical to the shareware 
  64.        distributed evaluation version, but it lacks registration 
  65.        reminders and it is branded with the registered user's name.
  66.  
  67.        Beyond the immediate tangible benefits, registration also 
  68.        provides support for the shareware software distribution concept.  
  69.        Shareware is not free software, nor is it in the public domain.  
  70.        Shareware means quality software that you try before you buy, 
  71.        generally at a far lower cost than a similar retail product, if 
  72.        one exists. We all benefit, but only if the users do their 
  73.        ultimate part of registering. If ViewSat is a useful addition to 
  74.        your system, please register your use.
  75.  
  76.        To register, fill in the form at the end of this document and 
  77.        send it with $20.00 (US) for a single machine to D. J. Rasmussen
  78.        Consulting, 10374 Palmento Drive, Riverside, Ca. 92505-1551, USA.  
  79.        You may also register through CompuServe (go SWREG) using my
  80.        registration ID of 260. Site licensing is also available.
  81.  
  82.        ViewSat makes no warranty of any kind, either express or implied, 
  83.        including but not limited to implied warranties of merchantability 
  84.        and fitness for a particular purpose, with respect to this 
  85.        software and accompanying documentation.
  86.  
  87.        David J. Rasmussen, author of ViewSat, SHALL NOT BE LIABLE FOR 
  88.        ANY DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, 
  89.        BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER 
  90.        INCIDENTAL OR CONSEQUENTIAL DAMAGES) ARISING OUT OF THE USE OF OR 
  91.        INABILITY TO USE ViewSat, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  92.  
  93.        ****************************************************************
  94.  
  95.  
  96.        Introduction:
  97.  
  98.           ViewSat is a program to aid the user in visually locating 
  99.        Earth orbiting satellites as they pass overhead. ViewSat is menu 
  100.        driven and supports mouse operation. It calculates and displays 
  101.        the positions of the satellite at a user selectable interval. It 
  102.        uses NASA 2-Line element sets for the necessary data to perform 
  103.        the calculations. 
  104.  
  105.        *** Note: Obtaining Satellite Element Sets.
  106.  
  107.          To achieve maximum satellite prediction accuracy, your element 
  108.        set should be as current as possible. NASA two-line element sets 
  109.        can be found on the Rancho Palos Verdes Bulletin Board System 
  110.        (RPV BBS), (310) 541-7299, operated by Dave Ransom, Jr. These 
  111.        files are located in file area #4, are of the form NASAxxx.ZIP 
  112.        and are updated approximately twice weekly in the ZIP compression 
  113.        format. ViewSat is also compatible with elements provided by Ted 
  114.        Molczan on the Canadian Space Society bulletin board. These 
  115.        elements are updated less often, but also appear in compressed 
  116.        format in file area #4 of the RPV BBS.  Their file names are of 
  117.        the form N2L-XXX.ZIP.
  118.  
  119.  
  120.        Commands:
  121.        
  122.           The software's commands are listed in their order of 
  123.        appearance on the display screen, from left to right, with the 
  124.        appropriate sub-menus as an indented sub-list below each menu 
  125.        item. Whenever a user entry is required, the keys are shown in 
  126.        angle brackets and represent the available values or commands to 
  127.        be entered. For example, Function key 2 is listed as <F2> and the 
  128.        R key is listed as <R>. The top menu bar commands may be selected 
  129.        by pressing <Alt> and the first letter of the menu desired. Other 
  130.        menus and commands in ViewSat may be selected by either using 
  131.        "Hot Keys", that is, the character that is highlighted in the 
  132.        command or by using the arrow keys and moving the reverse video 
  133.        bar to the desired command and pressing <Enter>. The available 
  134.        "Hot Keys" will be shown in this manual in angle brackets. To 
  135.        exit out of any command or menu, use the <Esc> key. This will 
  136.        allow you to "back out", one command at a time, all the way to 
  137.        the QUIT menu. Mouse support is also built into the program with 
  138.        the left button used as the <Enter> and the right button user as 
  139.        the <Esc> key. Moving the mouse with the left button pressed will 
  140.        "drag" the reverse video bar to the desired menu entry.
  141.        
  142.  
  143.        Screen Layouts:
  144.        
  145.           The top line contains the program name, version number, date 
  146.        of that version, copyright information and the time (either local 
  147.        or UTC). The next line displays the current active satellite name 
  148.        and element set filename. The fourth line is the "Main Menu Bar". 
  149.        The bottom line contains helpful information about current 
  150.        possible options. The following is a sample of the display screen 
  151.        with the ABOUT screen displayed:
  152.  
  153.  
  154.   ViewSat v1.08   12/08/92 (c) 1992 David J. Rasmussen            18:08:57 loc
  155.   Satellite: Mir                     Element file: JSCEL103.TXT
  156. ╔══════════════════════════════════════════════════════════════════════════════╗
  157. ║  About   Run   Setup   Utilities   Quit                                      ║
  158. ╟──────────────────────────────────────────────────────────────────────────────╢
  159. ║       ╔══════════════════════════════════════════════════════════════╗       ║
  160. ║       ║                                                              ║       ║
  161. ║       ║                   ViewSat v1.08  12/08/92                    ║       ║
  162. ║       ║                                                              ║       ║
  163. ║       ║                         Unregistered                         ║       ║
  164. ║       ║                                                              ║       ║
  165. ║       ║                                                              ║       ║
  166. ║       ║            Copyright (c) 1992 David J. Rasmussen             ║       ║
  167. ║       ║                      all right reserved                      ║       ║
  168. ║       ║                                                              ║       ║
  169. ║       ║      Please register ViewSat by sending $20.00 (US) to:      ║       ║
  170. ║       ║                 D. J. Rasmussen, Consulting                  ║       ║
  171. ║       ║                     10374 Palmento Drive                     ║       ║
  172. ║       ║                     Riverside, Ca. 92505                     ║       ║
  173. ║       ║                                                              ║       ║
  174. ║       ╚═════════════════ Press any key to continue ══════════════════╝       ║
  175. ║                                                                              ║
  176. ║                                                                              ║
  177. ╚══════════════════════════════════════════════════════════════════════════════╝
  178.   LTR-cmd  <Esc>-exit                                     <>-hilite  <┘-select
  179.  
  180.  
  181.  
  182.        Main Menu Bar
  183.           The main menu bar presents several menu options. They may 
  184.        be selected using the <Alt> key and the first letter of the 
  185.        command.  
  186.        
  187.        About                                            <Alt><A>
  188.           This menu selection displays information about the program and 
  189.        the author, along with registration status. When you register the 
  190.        program the user's registered name will be displayed in place of 
  191.        the "Unregistered" line. 
  192.  
  193.        *** Note: There is a 30 day evaluation period. After that time 
  194.        whenever this menu selection is brought up a message will be 
  195.        displayed to remind you to register your use as soon as possible 
  196.        (this is refered to as a "nag screen" is shareware circles). 
  197.        
  198.        Run                                              <Alt><R>
  199.           This menu structure pulls down a sub-menu with the possible 
  200.        simulation modes. They are as follows:
  201.          Print data to Screen
  202.          Print data to Disk
  203.          Run STS Orbit Plus
  204.        
  205.        Setup                                            <Alt><S>
  206.           This menu structure is used to configure the operational 
  207.        parameters pertaining to the satellite; element set; starting 
  208.        date, time, length and resolution of simulation; viewing 
  209.        location; and  data restrictions.
  210.        
  211.        Utilities                                        <Alt><U>
  212.           This menu structure pulls down a sub-menu with various useful 
  213.        disk and system functions. They are:
  214.          File maintenance 
  215.          OS shell
  216.          Set Time
  217.        
  218.        Quit                                             <Alt><Q>
  219.           This menu item is used to exit the program. Possible 
  220.        selections are:
  221.          Stay
  222.          Quit
  223.  
  224.           The Run sub-menu contains the selections which start the 
  225.        simulation (this is the main function of the program... to run 
  226.        simulations).
  227.        
  228.        Print data to Screen                             <S>
  229.           This starts the computer calculating the positions of the 
  230.        selected satellite from the viewing location for the time period 
  231.        with the data restrictions applied and each data point which 
  232.        passes the restrictions is printed to the screen. The following 
  233.        is a sample run for the Mir space station:
  234.  
  235.       Viewing location: Riverside, CA, Lat: 33.980, Lon: -117.365
  236.       Date and time at start of run: 13 Mar 1992 18:02:00 local
  237.  
  238.       Mir
  239.       1 16609U 86 17  A 92069.11824684  .00032647  00000-0  43671-3 0  1341
  240.       2 16609  51.6006  29.9062 0016242 159.2562 200.9020 15.57566868346660
  241.       Element epoch age at start of run: 4/23:11:43 (days/hr:mn:sc)
  242.  
  243.         Date       Time     Azim   Elev   RA     Dec     Alt     Range   Mag
  244.                    local    deg    deg   hr:mn   deg     km       km
  245.       17 Mar 1992 20:25:00 324.56   8.79 00:21  48.85   394.49  1491.82  3.7
  246.       18 Mar 1992 19:29:00 335.65   7.07 22:28  54.93   396.44  1616.16  3.5
  247.                   19:30:00 346.62  12.17 21:37  65.01   395.30  1291.98  2.7
  248.                   19:31:00   4.43  17.77 18:29  73.31   394.14  1041.25  1.8
  249.       19 Mar 1992 18:33:00 343.37   5.36 20:43  57.49   398.28  1752.88  3.4
  250.                   18:34:00 355.89   8.72 19:13  64.46   397.19  1501.06  2.7
  251.                   18:35:00  12.60  11.38 16:37  64.64   396.06  1336.56  2.2
  252.                   18:36:00  32.28  12.14 14:33  53.41   394.89  1294.08  1.8
  253.                   18:37:00  51.19  10.50 13:35  37.80   393.70  1385.23  1.8
  254.       19 Mar 1992 20:09:00 310.07   8.73 01:03  37.76   394.15  1497.62  4.1
  255.                   20:10:00 308.53  16.47 01:42  40.83   392.95  1091.43  3.1
  256.  
  257.           The top 10 lines do not scroll and they show information about 
  258.        the viewing location, starting date and time, the satellite 
  259.        elements, the age of the element epoch at the start of the run 
  260.        and column headings for the position data. 
  261.        
  262.        *** Note: The age of the element epoch is important because with 
  263.        many low altitude satellites (or with satellites which make many 
  264.        orbital maneuvers, such as the space shuttle) the position data 
  265.        accurracy degrades with time. For the most part elements which 
  266.        are less than a month old will be accurate to about two minutes 
  267.        time for the given position.
  268.        
  269.        Each data line contains the following information: 
  270.  
  271.        Date (shown on the first line of data for an orbit which passes 
  272.          the data restrictions). 
  273.        Time (local or UTC as selected). 
  274.        Azimuth (compass angle increasing clockwise from north). 
  275.        Elevation (angle above mean horizon, 90 degrees is straight up). 
  276.        Right Ascension (hours and minutes measured from the prime celestial 
  277.          meridian). 
  278.        Declination (angle above or below the celestial horizon). 
  279.        Altitude (satellite distance the earth's surface). 
  280.        Range (linear distance from the viewing location to the satellite). 
  281.        Magnitude (apparent brightness "guess"-timate, for reference 
  282.          Jupiter is -2.5 and polaris (the north star) is 2.1).
  283.        
  284.        *** Note: While the data is being printed the user may press the 
  285.        <Space> key (or the left mouse button) to temporarily stop the 
  286.        display. Press any key to restart it. Press the <Esc> key to stop 
  287.        the simulation where it is at.
  288.  
  289.        Print data to Disk                               <D>
  290.           This starts the computer calculating the positions of the 
  291.        selected satellite from the viewing location for the time period 
  292.        with the data restrictions applied and each data point which 
  293.        passes the restrictions is printed to a disk file which then can 
  294.        be viewed or printed to a printer. The data is the same as above.
  295.        The filename used will be @VIEWSAT.xxx (the xxx is replaced by a 
  296.        3 digit number starting with 000. If a file with this extension 
  297.        already exists, the number will be incremented. If all possible 
  298.        files already exist the default @VIEWSAT.000 will be used).
  299.  
  300.        Run STS Orbit Plus                               <R> 
  301.        
  302.           This is a convenient way to access Dave Ransom's excellent 
  303.        graphic satellite viewing program (it draws a map projection of 
  304.        the earth and the ground track of a selected satellite). I think 
  305.        this is the best graphic program available, so I figured I might 
  306.        as well make it easy to use both his program and mine. It is 
  307.        available from the Rancho Palos Verdes BBS (310-541-7299) which 
  308.        he operates. The file is SOP92xx.PAK in file area #4. 
  309.        
  310.        *** Note: see list at the end of this document for other BBS 
  311.        where tracking programs and element sets are available.
  312.  
  313.  
  314.           The Setup menu structure is used to configure the operational 
  315.        parameters pertaining to the satellite; element set; starting 
  316.        date, time, length and resolution of simulation; viewing 
  317.        location; and  data restrictions. The structure is an "entry 
  318.        screen", where the data is directly entered in the highlighted 
  319.        field. The highlighted field is selected using the arrow keys, 
  320.        mouse, <Tab> key, or <Enter> key. The data is then entered and 
  321.        the <Enter> key is pressed to save the data (the <Alt><R> key 
  322.        will abort the current data entry). The <Esc> key exits this 
  323.        screen back to the main menu bar and the current entries are 
  324.        saved as the new defaults.
  325.        
  326.           Some of the fields have associated lists of possible entries 
  327.        to be picked from. The message "<F2>-pick from list" will appear 
  328.        on the help line for these fields. The user may then press the 
  329.        <F2> function key to bring up the pick list. The arrow keys, 
  330.        <PgUP>, <PgDn>, <Home> and <End> keys or mouse may then be used 
  331.        to highlight the desired entry then press the <Enter> key to 
  332.        make the selection. As an alternative, the first few letters of 
  333.        the desired entry may be typed and the cursor will move to 
  334.        highlight the next entry in the list which matches the characters 
  335.        typed. The current matching characters are displayed across the 
  336.        top of the pick list window. The following is a sample Setup 
  337.        entry screen with a pick list brought up and the matching 
  338.        characters displayed:
  339.  
  340.        ╔═══════════════════════════ System Setup ═══════════════════════════╗
  341.        ║ Element data file           JSCEL103.TXT                           ║
  342.        ║ Current satellite name      Mir                    NORAD #: 21255  ║
  343.        ║ Start date of simulation:   03/14/199┌────────────RIV─────────────┐║
  344.        ║ Length of run:(dd/hh:mm)        10/00│  Richmond, KY              ░║
  345.        ║ Time resolution:(minutes)        1.00│  Richmond, UT              ░║
  346.        ║                                      │  Richmond, VA              ░║
  347.        ║ Viewing location name       Riverside│  Rifle, CO                 ▓║
  348.        ║ Viewing locaton latitude:       33.98│  Rio de Janeiro, Brazil    ░║
  349.        ║               Elevation:       249.1 │> Riverside, CA             ░║
  350.        ║ Use local timezone:         Y        └────────────────────────────┘║
  351.        ║ Minimum sat. elevation:          5.0   Maximum sun elevation: -6   ║
  352.        ║ Maximum sat. magnitude:          6.5   Minimum Mean Motion:    4.0 ║
  353.        ║ Print satellites skipped:   N                                      ║
  354.        ║                                                                    ║
  355.        ╟────────────────────────────────────────────────────────────────────╢
  356.        ║          enter Location name         <F2>-pick from list           ║
  357.        ╚════════════════════════════════════════════════════════════════════╝
  358.  
  359.           The first field is the Element data filename. This may be 
  360.        directly entered or picked from a directory list. When picking 
  361.        from a list, the user may change directory (or disk) by 
  362.        highlighting the appropriate item and pressing enter. The new 
  363.        directory list will then be displayed. Once the desired filename 
  364.        is highlighted, press <Enter> to load that file. The file is then 
  365.        searched for the current satellite name and, if found, the new 
  366.        elements are loaded and displayed.
  367.        
  368.           The next field is the Satellite name. This again may be 
  369.        directly entered or picked from a list of all the satellite names 
  370.        in the current element data file. If the name is typed in, a 
  371.        search is then made for the first occurrance in the element data 
  372.        file for a satellite name that matches at least the number of 
  373.        characters entered (ie. if you enter COSM, the first Cosmos entry 
  374.        will be selected from the data file). If this is not the desired 
  375.        file, press <F2> and the list of available satellites will be 
  376.        displayed (it may take a few seconds to load, sort and display 
  377.        the list, so please be patient). Once the desired satellite name 
  378.        is highlighted, press <Enter> to load the elements for it. Once a 
  379.        satellite has been selected, the elements will be loaded and 
  380.        displayed. The following is a sample element data display: 
  381.  
  382.        
  383.        ╔════════════════════════════════════════════════════════════════╗
  384.        ║ Satellite Name:              Mir                               ║
  385.        ║ Satellite NORAD Number:      16609                             ║
  386.        ║ Satellite Visual Magnitude: ≈1.7 (@ 1000 km, 50% illuminated)  ║
  387.        ║                                                                ║
  388.        ║ Launch Year:                 1986                              ║
  389.        ║ Launch Number:               17                                ║
  390.        ║ Launch Piece:                A                                 ║
  391.        ║                                                                ║
  392.        ║ Elements Epoch:              09 Mar 1992 @ 02:50:17 UTC        ║
  393.        ║ Orbit Number at Epoch:       34666                             ║
  394.        ║                                                                ║
  395.        ║ Orbital Inclination:         51.6006°                          ║
  396.        ║ RA of Ascending Node:        29.9062°                          ║
  397.        ║ Eccentricity:                0.0016242                         ║
  398.        ║ Argument of Perigee:         159.2562°                         ║
  399.        ║ Mean Anomaly:                200.9020°                         ║
  400.        ║ Mean Motion:                 15.57566868 rev/day               ║
  401.        ║ BSTAR Drag:                  0.000436710                       ║
  402.        ║                                                                ║
  403.        ╚══════════════════ Press any key to continue ═══════════════════╝
  404.        
  405.        *** Note: The file TRAKSAT.DOC by Paul E. Traufler contains a 
  406.        very good description of these classical orbital elements and the 
  407.        calculations used in this program to display the satellite 
  408.        positions.
  409.  
  410.           The next field is the NORAD # (number). This again may be 
  411.        directly entered or picked from a list of all the NORAD numbers 
  412.        in the current element data file. If the number is typed in, a 
  413.        search is then made for the first occurrance in the element data 
  414.        file for a satellite with that number. If this is not the desired 
  415.        file, press <F2> and the list of available satellites will be 
  416.        displayed (it may take a few seconds to load, sort and display 
  417.        the list, so please be patient). Once the desired satellite 
  418.        number is highlighted, press <Enter> to load the elements for it. 
  419.        Once a satellite has been selected, the elements will be loaded 
  420.        and displayed. 
  421.  
  422.           The next two fields are the starting date and time of the 
  423.        simulation. The default value is the system time and date when 
  424.        ViewSat is started. They may then be changed to any other valid 
  425.        date (01/01/1600 to 12/31/3999) and time (00:00 to 23:59). They 
  426.        reflect the time zone selected (either local or UTC).
  427.        
  428.           Then comes the length of run field. This is in days, hours and 
  429.        minutes from the starting date and time. On my 16Mhz 386 sx it 
  430.        takes about 1 second per day to calculate and display the 
  431.        positions for a typical satellite. The initial default is 10 
  432.        days. I set this field to 00/02:00 (2 hours) and the starting 
  433.        time to about 30 minutes past sundown, then I select all 
  434.        satellites in the element data file to find any good satellites 
  435.        in an evening.
  436.        
  437.           The next field is for time resolution (expressed in minutes). 
  438.        This is the resolution of the data to be displayed. In other 
  439.        words, if it is set to 1.0 then each line of data will be in 1 
  440.        minute increments, or if it is set to 0.5 then each line will be 
  441.        in 30 second intervals. The initial default is 1 minute.
  442.        
  443.           The next field if the viewing location name. This can be a 
  444.        city name picked from a valid city file (STSPLUS.CTY is included 
  445.        with this program and comes from Dave Ranson's STSPLUS program) 
  446.        or anything the user wishes may be entered (for instance if your 
  447.        city is not in the city file). This is only used when printed out 
  448.        in the heading of the simulation data. If the user presses the <F2> 
  449.        key then a window pops up for the filename of the city file to 
  450.        use (the default is STSPLUS.CTY) enter a valid file name and 
  451.        press <Enter> and then the pick list will be brought up to make a 
  452.        selection from. The current (closest matching) city name is 
  453.        highlighted, then highlight the new city and press enter. The 
  454.        longitude, latitude and height (elevation) are then set from the 
  455.        data in the file.
  456.  
  457.        *** Note: Most heights are zero in the city file. Either the city 
  458.        file may be edited to change this or the user may enter their 
  459.        city's elevation (in meters) directly in this program. 
  460.        
  461.           If the user can not find a match in the city file and they 
  462.        entered their own viewing location name then the next three 
  463.        fields should also be set.
  464.  
  465.           Below is an example of the STSPLUS.CTY file. The format of the 
  466.        tracking station file is;
  467.  
  468.           City Name         Long.  Lat.  Ht.
  469.                             (deg)  (deg) (m)
  470.           "Riverside, CA",-117.365,33.98,249
  471.           "Riverton, WY",-108.385,43.025,0
  472.           "Riyadh, Saudi Arabia",46.7833,24.5167,0
  473.           "Roanoke, VA",-79.9455,37.2703,0
  474.           "Rochester, MN",-92.4675,44.0225,0
  475.           "Rochester, NH",-70.975,43.3033,0
  476.  
  477.           The city name can be up to 25 characters long while the 
  478.        longitude (negative = west), latitude (negative = south), and 
  479.        height can be up to 10 characters long. A comma or a space MUST 
  480.        separate the data and the city name MUST be enclosed in double or 
  481.        single quote marks. The height measurement is the elevation above 
  482.        mean sea-level and is in meters.
  483.        
  484.           The STSPLUS.CTY file can hold a maximum of 1450 viewing 
  485.        locations in it. The user can enter city data into the 
  486.        STSPLUS.CTY file in any order but it would be wise to include the 
  487.        data in an alphabetical order by states or country.
  488.        
  489.           The next three fields contain the viewing location longitude, 
  490.        latitude, and height. These are set automatically when a city if 
  491.        picked from the city file, or they may be directly entered (or 
  492.        altered) by the user here. They are then saved as the new default 
  493.        values.
  494.        
  495.           The next field is the "Time from UTC". This is the number of 
  496.        hours from UTC to the viewing location local time:
  497.          PST = UTC - 8.0 hours, MST = -7.0, CST = -6.0, EST = -5.0
  498.          PDT = -7.0
  499.        
  500.        *** Note: Remember to change this when "Daylight Savings Time" 
  501.        begins and ends. Also note that the time change is not taken into 
  502.        account if you run a simulation which overlaps the start (or end) 
  503.        of "Daylight Savings Time".
  504.        
  505.           The next field is Yes/No (boolean) type. It requires either a 
  506.        <Y> or <N> key, or click the left mouse button while the field is 
  507.        highlighted to change it to the other state.
  508.        
  509.           The field is "Use local timezone". If Yes then all data will be 
  510.        displayed as local time, if No then the data will be UTC (Universal 
  511.        time). Note that all calculations are performed using UTC and the 
  512.        conversion is done (if necessary) just prior to displaying it. 
  513.        
  514.           The next field sets the Minimum Satellite Elevation. This is the 
  515.        elevation angle (angle above the mean horizon) that the satellite 
  516.        must be above for position data to be printed. I like to use 5.0 
  517.        degrees (ten degrees is about the height of your closed fist with 
  518.        you arm outstretched). Valid range is +/- 90 degrees.
  519.        
  520.           The next field is the Maximum Sun Elevation. This is how far 
  521.        below the horizon the sun must be for visible pass data to be 
  522.        printed. This represents how dark the sky will be and therefore 
  523.        how easy it will be to pick out the satellite from the background 
  524.        sky. For bright satellites (Mir, HST, and the space shuttle) I 
  525.        use -6 degrees (civil twilight), but for most others I use 12 
  526.        degrees (nautical twilight). Valid range is +/- 90 degrees.
  527.  
  528.           The next field is the Maximum Satellite Magnitude. The satellite 
  529.        magnitude calculation uses the sun position, satellite range, and 
  530.        phase angle (angle between the sun, satellite and observer). If a 
  531.        satellite's magnitude drops below (brightens) the entered value 
  532.        during a pass then the entire passes data will be printed. This 
  533.        helps eliminate poor viewing passes from the data printed. Novice 
  534.        satellite viewers should look for satellites with maximum magnitude 
  535.        of 4.5 (experienced viewers can probably find them up to 8th 
  536.        magnitude depending on "seeing" conditions).
  537.  
  538.           The next field is the Minimum Mean Motion. A satellite with a 
  539.        Mean Motion of less than 4.0 will probably have a highly eliptical 
  540.        orbit and/or an altitude of greater than 2000 km and therefore a 
  541.        visual magnitude of greater than 6. This then is the quickest means 
  542.        to filter out satellites from the element data file that would be 
  543.        least likely to be visible.
  544.  
  545.           The next field is another Yes/No field to select whether the 
  546.        satellite NORAD Number and Name should be printed to the output 
  547.        file if it is skipped because of it's Mean Motion being less than 
  548.        the Minimum Mean Motion value entered above. This can be useful if 
  549.        you expect a selected satellite to make a visible pass and it does 
  550.        not show up in the output (it may have been skipped due to Mean 
  551.        Motion too small).
  552.  
  553.  
  554.           The Utilities menu structure pulls down a sub-menu with 
  555.        various useful disk and system functions. They are:
  556.        
  557.           The first utility is file maintenance. This brings up a 
  558.        directory list with all files in the current directory shown, 
  559.        followed by any sub-directories and any other available drives. 
  560.        The user may use the arrow keys, <PgUp>, <PgDn>, <Home>, and 
  561.        <End> keys or a mouse to move the highlight bar around. The user 
  562.        may then Copy, Delete, Rename, Print, or View the highlighted 
  563.        file by pressing the associated "hot key" (the first character in 
  564.        each function, ie. to Copy press <C> key). For Copy the entire 
  565.        path and filename must be entered. Delete requires verification 
  566.        before the file is deleted. To Rename just enter the new filename 
  567.        and extension. Print sends the file directly to the system PRN 
  568.        device. File View opens a new window with the file displayed in 
  569.        ASCII (press <Ctrl><H> to view the file in Hexadecimal mode). The 
  570.        arrow keys, <PgUp>, <PgDn>, <Home>, <End> and the mouse may be 
  571.        used to move around in the file. <Esc> to go back to the 
  572.        directory list.
  573.        
  574.           The next utility is "OS Shell". This temporarily shuts down 
  575.        ViewSat (and save most of it to EMS memory or disk) to allow the 
  576.        user to run other DOS programs. Since most of the program memory 
  577.        is saved to EMS memory (if available) or to disk, there should be 
  578.        plenty of memory to run any program you are currently able to 
  579.        run. Type EXIT at the DOS prompt to return to ViewSat.
  580.        
  581.        *** Note: Do not try to load TSR programs from the OS Shell as 
  582.        they may cause your system to "hang" requiring a "cold boot". 
  583.        However you should be able to run any TSRs which you had 
  584.        previously loaded.
  585.        
  586.           The last utility allows the user to set the system time. Enter 
  587.        the time in 24 hour (military) format and press enter when ready 
  588.        to set the clock to the entered time.
  589.  
  590.        *** Note: THE SYSTEM HARDWARE CLOCK MAY BE RESET ALSO IF THE USER 
  591.        HAS DOS VERSION 3.3 AND ABOVE. Use some caution with this option. 
  592.  
  593.  
  594.           The Quit menu item is used to exit the program. Possible 
  595.        selections are:
  596.        
  597.           Stay (this exits the quit menu, staying in ViewSat).
  598.           Quit (this exits ViewSat, returing control to DOS).
  599.  
  600.  
  601.          My thanks go out to the following people who helped me either 
  602.        directly or indirectly on this program.
  603.  
  604.           David H. Ransom, Jr., of Rancho Palos Verdes, CA. Dave is the 
  605.        SYSOP of the RPV BBS. I included the city data file from his 
  606.        program STS Orbit Plus (STSPLUS). I would highly recommend his 
  607.        programs to any person interested in astrodynamics. Other program 
  608.        he wrote are: STSOrbit, JPLClock, and AstroClock.
  609.  
  610.           T.S. Kelso, SYSOP of the Celestial BBS where current satellite 
  611.        data can be downloaded and where the core for this program was 
  612.        obtained (SGP4SDP4.PAS the satellite position propogation 
  613.        models). Several other satellite tracking programs are also 
  614.        available on his BBS along with a vast amount of satellite 
  615.        information.
  616.        
  617.           Paul Traufler, author of TrakSat, whose documentation I used 
  618.        in preperation of this documentation. TrakSat is another very 
  619.        good satellite tracking program that combines text and graphics 
  620.        output all in one program.
  621.  
  622.           Please feel free to contact me to discuss ViewSat or other 
  623.        computer problems. I can reached through the following BBS:
  624.  
  625.              RPV BBS (owned and operated by Dave Ransom, Jr)
  626.              Rancho Palos Verdes, Ca.
  627.              310-541-7299 
  628.              24 hours, 9600/2400/1200 baud.
  629.  
  630.              Celestial RCP/M (owned and operated by T. S. Kelso)
  631.              Fairborn, Ohio
  632.              513-427-0674  
  633.              24 hours, 9600/2400/1200 baud.
  634.        
  635.           I can also be reached by E-Mail on Compuserve at 75176,1775 or 
  636.        throught the Astronomy and Space Forums on Compuserve.
  637.   
  638.           I call up these BBS about three times a week to check my mail 
  639.        and do some file transfers. These BBS are geared towards 
  640.        astronomical interests. The latest version of ViewSat and Dave 
  641.        Ransom's STSPLUS can be downloaded from these BBS also.
  642.  
  643.           This program is produced by a member of the Association of 
  644.        Shareware Professionals (ASP). ASP wants to make sure that the 
  645.        shareware principle works for you. If you are unable to resolve a 
  646.        shareware-related problem with an ASP member by contacting the 
  647.        member directly, ASP may be able to help. The ASP Ombudsman can 
  648.        help you resolve a dispute or problem with an ASP member, but 
  649.        does not provide technical support for members' products. Please 
  650.        write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 
  651.        or send a CompuServe message via CompuServe Mail to ASP Ombudsman 
  652.        70007,3536.
  653.  
  654.  
  655.        
  656.           The REGISTERED user of ViewSat will receive notification when a 
  657.        new version becomes available. To obtain any future versions of 
  658.        ViewSat will require the user to send $5.00 (US) and I will send 
  659.        you the new version on a disk size you specify.
  660.  
  661.        (NON-REGISTERED users are required to send $20.00 (US). They then 
  662.        become REGISTERED users.)
  663.  
  664.        *** Note: PLEASE STATE THE DISK SIZE YOU REQUIRE!
  665.  
  666.        The REGISTERED versions of ViewSat are for PERSONAL USE and are 
  667.        NOT to be used COMMERCIALLY (ie. selling the output for profit).
  668.  
  669.  
  670.        Custom Versions of the Software:
  671.  
  672.           If you require any modifications or changes to the software, 
  673.        please include detailed information describing all changes you 
  674.        are interested in. Customization fees will be based on the extent 
  675.        of the modifications required to the software and any time 
  676.        constraints, or they may just be incorperated in the next general 
  677.        release of the software (at the author's discretion).
  678.  
  679.  
  680.  
  681.        The following files should have been included in the archive 
  682.        file:
  683.  
  684.            ViewSat.EXE   The program.
  685.            STSPLSUS.CTY  The city file for tracking stations.
  686.            ViewSat.DOC   ViewSat program documentation.
  687.            JSCELxxx.TXT  This is the latest orbital element data set for 
  688.                          three bright easily viewed satellites:
  689.                          Mir Soviet (???) space station,
  690.                          HST Hubble Space Telescope,
  691.                          GRO Gamma Ray Observatory.
  692.              ORDER.FRM   This file contains ViewSat order forms.
  693.  
  694.  
  695.  
  696.  
  697.                                 ViewSat                         v1.08
  698.                        Satellite Viewing Program
  699.  
  700.                  ViewSat Order Form (PERSONAL USE ONLY)
  701.      ----------------------------------------------------------------
  702.  
  703.      MAKE CHECKS PAYABLE TO:
  704.  
  705.          David J. Rasmussen
  706.          10374 Palmento Drive
  707.          Riverside, Ca. 92505
  708.  
  709.      ----------------------------------------------------------------
  710.  
  711.       Qty
  712.  
  713.      ____ ViewSat REGISTERED Version     @ $20.00 each     $_________
  714.  
  715.  
  716.         * Price includes shipping and handling *  Total    $_________
  717.  
  718.      Diskette type (check one):   [ ] 5-1/4" 360K  [ ] 3-1/2" 720K
  719.                                   [ ] 5-1/4" 1.2M  [ ] 3-1/2" 1.44M
  720.  
  721.      Numeric Coprocessor Support:
  722.      [ ] Currently have (or plan to get)    [ ] No Numeric Coprocessor
  723.  
  724.      Payment: (check one):
  725.      [ ] Check  [ ] Money Order  [ ] Other
  726.  
  727.  
  728.     Checks and Money Orders must be drawn on U.S. banks in U.S. funds.
  729.                              ** PLEASE PRINT **
  730.  
  731.  
  732.       Name    _______________________________________________________
  733.  
  734.       Company _______________________________________________________
  735.  
  736.       Address _______________________________________________________
  737.  
  738.               _______________________________________________________
  739.  
  740.  
  741.       Phone   _____________________  Bus. ___________________________
  742.  
  743.  
  744.  
  745.       Comments ______________________________________________________
  746.  
  747.                ______________________________________________________
  748.  
  749.  
  750.  
  751.